Diretrizes para envio de feed

Neste guia, descrevemos como fornecer seu feed do Micromobility ao Google depois que ele for gerado. Para ver uma descrição sobre como criar seu feed, consulte as especificações na guia Referência.

Diretrizes para feeds

Como parte do processo para enviar o feed do Micromobility gerado ao Google, esteja ciente do seguinte processo e diretrizes:

  • Verifique se os dados de disponibilidade de bicicletas e de tarifas dinâmicas, quando aplicável, estão atualizados. Para isso, faça upload de uma nova versão do feed para o host do feed GBFS a cada 30 segundos. Além disso, a latência para a recuperação dos dados não pode exceder 30 segundos.

  • Para enviar seu feed ao Google, é preciso oferecer suporte a HTTP GET.

Entrega de feed com HTTP GET

O Google busca o feed no local configurado com uma solicitação HTTPS GET e aceita os seguintes métodos de autenticação:

  • Autenticação por resumo HTTP: se você implementar isso, envie o nome de usuário e a senha configurados por e-mail para o suporte a parceiros do Micromobility.
  • Campos de cabeçalho HTTP personalizados:para que isso seja compatível, como parte da sua solicitação ao Google, envie os campos e os valores de cabeçalho necessários.
  • Parâmetros GET: se forem necessários mais parâmetros GET, adicione-os ao endereço do host antes de enviá-lo por e-mail ao suporte do parceiro do Micromobility.

Para otimizar o tamanho do arquivo durante a transferência, o Google é compatível com a compactação gzip no cabeçalho HTTP. Especificamente, o Google envia Accept-Encoding: gzip, deflate no cabeçalho da solicitação HTTP e aceita a resposta com o cabeçalho HTTP Content-Encoding: gzip.

Após determinar o local e os detalhes do host, envie os detalhes da configuração por e-mail para o suporte ao parceiro do Micromobility.

Fragmentação de feed

Para fragmentar um feed, divida todo o feed em vários subconjuntos não cruzamentos. Dependendo dos sistemas de back-end, dos tipos de frota e dos tamanhos, a fragmentação pode ser necessária.

Para detalhes técnicos sobre quando e como fragmentar seu feed, consulte Fragmentação de feed na seção "Referência".

O Google usará o mesmo mecanismo para buscar feeds fragmentados e não fragmentados, conforme descrito em Envio de feed com HTTP GET.

Depois de determinar o local do host e os detalhes de cada fragmento, envie por e-mail os detalhes de configuração de cada fragmento com as áreas metropolitanas que o fragmento cobre para o suporte a parceiros do Micromobility.